Purpose

To enable jmx monitoring for enforcer.

Fixes #3076

JConsole Agent

1. Add following section to your JAVA_OPTS property:

export JAVA_OPTS="-Dchoreo.connect.jmx.metrics.enabled=true -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=11111 -Dcom.sun.management.jmxremote.rmi.port=9999 -Dcom.sun.management.jmxremote.local.only=false -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Djava.rmi.server.hostname=0.0.0.0"

2. Add port mapping to enforcer:

  enforcer:
    ...
    ports:
     ...
      - "9999:9999"
      - "11111:11111"

2. Run jconsole(in your java home /bin directory) and connect to localhost:11111 or service:jmx:rmi://localhost:11111/jndi/rmi://localhost:9999/jmxrmi.

Jolokia Agent

1. Download Jolokia JVM-Agent from here. For example downloaded jar name is jolokia-jvm-1.7.1.jar

2. Add the above jar to the enforcer droppings location.

3. Add following section to your JAVA_OPTS property (Use the exact name of the jar you added to the droppings replacing jolokia-jvm-1.7.1.jar):

export JAVA_OPTS="-Dchoreo.connect.jmx.metrics.enabled=true -javaagent:/home/wso2/lib/dropins/jolokia-jvm-1.7.1.jar=port=7777,host=0.0.0.0"

4. Add port mapping to enforcer:

  enforcer:
    ...
    ports:
     ...
      - "7777:7777"

5. Try following URLs in the browser:

View ext auth service thread pool config
http://localhost:7777/jolokia/read/org.wso2.choreo.connect.enforcer:type=ThreadPoolConfig

View ext auth service metrics
http://localhost:7777/jolokia/read/org.wso2.choreo.connect.enforcer:type=ExtAuthMetrics

Reset ext auth service metrics record
http://localhost:7777/jolokia/exec/org.wso2.choreo.connect.enforcer:type=ExtAuthMetrics/resetExtAuthMetrics

Automation tests

• Unit tests added: No
• Integration tests added: No
  Perf tests results - https://docs.google.com/spreadsheets/d/1WNLiA_2VXqMIIGtUjBM8UQ-4XVlv1kwk_1UvucXtxzk/edit#gid=0

Tested environments

OS: Darwin
Env: Docker

Maintainers: Check before merge

• Assigned 'Type' label
• Assigned the project
• Validated respective github issues
• Assigned milestone to the github issue(s)